Command Reference
The DevAssure CLI allows you to execute AI-powered end-to-end UI tests directly from the terminal.
You can authenticate, initialize projects, run tests, generate reports, and manage execution history — all without using the IDE.
This page provides a complete reference of all supported commands and flags.
Authentication
- Authenticate your CLI before running tests.
| Command | Description |
|---|---|
devassure login | Login via OAuth2 (opens browser) |
devassure logout | Logout and clear stored tokens |
devassure add-token <token> | Add and validate an authentication token |
Configuration
Initialize DevAssure configuration in your project directory.
| Command | Description |
|---|---|
devassure init | Initialize .devassure/ config in the current directory |
Running Tests
devassure run-tests / devassure run
Run tests using the current directory as the project root.
devassure run-tests [options]
Options:
| Flag | Description |
|---|---|
--path <path> | Project path (default: current directory) |
--csv <path> | Path to a CSV file containing test cases. Relative paths resolve from the current directory or .devassure/. File must have a .csv extension. |
--tag / --tags <tags> | Comma-separated tag values (e.g., --tag=smoke,regression) |
--priority / --priorities <values> | Comma-separated priority values (e.g., --priority=P0,P1) |
--folder / --folders <paths> | Comma-separated folder paths (e.g., --folder=admin/users,project/integration) |
--query / --queries <query> | Text search across summary, steps, and tags |
--filter / --filters <filter> | Raw filter string — takes precedence over all other filter flags |
--archive <folder> | After the run, write devassure-results-<session-id>.zip into this folder |
If --filter is provided, all other filter flags (--tag, --priority, --folder, --query) are ignored.
devassure resume
Resume a previously started test session.
devassure resume --last
devassure resume --session-id
| Flag | Description |
|---|---|
--session-id <id> | ID of the session to resume |
--last | Resume the most recently executed session |
Reports & Statistics
Open Report
Open the HTML report for a test session in your browser.
devassure open-report --last
devassure open-report --session-id
devassure open-report --archive ./reports/devassure-results-.zip
| Flag | Description |
|---|---|
--session-id <id> | Open report for a specific session |
--last | Open report for the last session |
--archive <path> | Open report from a zip archive — no database required |
One of --archive, --session-id, or --last is required.
Archive Report
Archive a session's report as a zip file.
devassure archive-report --output-dir ./reports --last
devassure archive-report --output-dir ./reports --session-id
| Flag | Description |
|---|---|
--output-dir <dir> | (Required) Output directory for the zip file |
--session-id <id> | Session to archive |
--last | Archive the last session |
Output file name: devassure-results-<session-id>.zip
devassure summary
Print a summary of a test session's results.
devassure summary --last
devassure summary --session-id
devassure summary --last --json
| Flag | Description |
|---|---|
--session-id <id> | Summarize a specific session |
--last | Summarize the last session |
--json | Output as JSON (includes session_id, environment, scenarios, score, grouped_failures, passed_validations, duration_ms, duration_string) |
devassure stats
Show storage and session statistics.
devassure stats
Displays test session count, scenario count, and storage usage.
Maintenance
devassure cleanup
Remove old execution history to free up space.
devassure cleanup --retain-days 7
devassure cleanup --retain-sessions 10
| Flag | Description |
|---|---|
--retain-days <n> | Keep sessions from the last N days |
--retain-sessions <n> | Keep the last N sessions |
If no flags are provided, you will be prompted to delete all sessions.
Utility
| Command | Description |
|---|---|
devassure version | Show the installed CLI version |
devassure help | Show help information |
Global Options
| Flag | Description |
|---|---|
--verbose | Enable verbose logging for any command |